Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 2 - QuickDraw GX Memory Management / QuickDraw GX Memory Management Reference

Functions / Loading and Unloading Objects

GXLoadColorProfile

You can use the GXLoadColorProfile function to load a color profile into memory.

void GXLoadColorProfile(gxColorProfile target);

target

A reference to the color profile object to be loaded into memory.

DESCRIPTION

The GXLoadColorProfile function moves a color profile object from disk storage to the active graphics client heap of your application. When you or QuickDraw GX unload a color profile object from memory to disk storage using the GXUnloadColorProfile function, QuickDraw GX creates a 4-byte stub that remains in the graphics client heap. When you use the GXLoadColorProfile function to retrieve the stored object, QuickDraw GX obtains the location of the stored color profile object from the stub.

ERRORS, WARNINGS, AND NOTICES

Errors

out_of_memory

color_profile_is_nil

SEE ALSO

For additional information about loading objects from disk storage to memory and unloading objects from memory to disk storage, see the section "Loading and Unloading Objects" beginning on page 2-12.

The GXUnloadColorProfile function is described in the next section.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help